Skip to main content

formattedTop

Type

property

Summary

Reports the distance between the top edge of the stack window and the topmost object in a card or group.

Syntax

get the formattedTop of {<card> | <group>}
get the formattedTop of <chunk> of <field>

Description

Use the formattedTop property to find the boundary of a group or chunk, or to determine how far to scroll vertically to bring a chunk of text into the viewable area of a field.

If you specify a card or group, the formattedTop reports the distance in pixels between the top edge of the stack window and the top edge of the uppermost object in the card or group. (Objects whose visible property is false are ignored.)

If the uppermost object is above the top of the stack window, the formattedTop is a negative number.

The formattedTop of a chunk in a field is the distance from the top of the stack to the top of an imaginary box containing the text in the chunk.

Examples

get the formattedTop of card "Preferences"
set the scroll of field 1 to the formattedTop of line 30 of field 1

command: group

glossary: object, property, negative, stack window, chunk

keyword: card, field

object: stack

property: formattedHeight, pixels, visible, formattedLeft

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile

Thank you for your feedback!

Was this page helpful?